@qjp88995/provider-client 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,9 +1,12 @@
 export { type CenterFetchOptions, createCenterFetch } from './center-fetch.js';
 export { type DirectModel, DirectModelResolver, type DirectVendor, } from './direct-resolver.js';
 export { ProtocolUnavailableError, ProviderClientError, type ProviderClientErrorCode, } from './errors.js';
+export { classifyCode, createJustOne, type JustOne, JUSTONE_BASE_URL, JUSTONE_ENDPOINTS, JUSTONE_FAILURE_KINDS, JUSTONE_PRICE_FEN, JUSTONE_PRICING_EXPORTED_AT, JUSTONE_TIMEOUT_MS, type JustOneAttemptRecord, type JustOneCallOptions, type JustOneConnection, type JustOneEndpointKey, type JustOneEndpointSpec, justOneEndpointSpec, type JustOneFailureKind, type JustOneOptions, type JustOneParams, JustOneParamsError, type JustOneParamsOf, type JustOneParamSpec, justOnePriceFen, type JustOneResult, JustOneUpstreamError, type JustOneUpstreamFailureKind, type NormalizedParams, normalizeParams, } from './justone/index.js';
+export { type AudioOutcome, type AudioRequest, BibiGptApiError, BibiGptNetworkError, buildPolishPrompt, type CacheKeyOpts, createMedia, type CreateMediaInput, directMediaConnection, type FileOutcome, type FileRequest, isMediaKind, localizeSummaryHeadings, MEDIA_ADAPTERS, MEDIA_CAPABILITIES, MEDIA_KINDS, type MediaAdapter, type MediaCapability, type MediaConnection, type MediaInput, type MediaKind, type MediaService, type MediaSettings, type MediaSettingsByKind, MediaUpstreamError, pageFromExpertName, type ParsedImage, parseParserPackage, type TokenUsage, type UploadLimitHint, type VideoLinkChapter, type VideoLinkOutcome, type VideoLinkRequest, type VideoLinkSubtitle, ZHIPU_AUDIO_MAX_BYTES, ZHIPU_FILE_TOOL_TYPES, ZHIPU_MIME_TO_EXT, type ZhipuFileToolType, } from './media/index.js';
 export { type ModelFileStore, type ModelHandle, type ModelRef, type ModelResolver, type ResolveOptions, type UploadedFile, } from './model-handle.js';
-export { type FetchForOptions, ProviderClient, type ProviderClientOptions, } from './provider-client.js';
+export { type FetchForOptions, type JustOneClientOptions, type MediaOptions, ProviderClient, type ProviderClientOptions, type WebSearchOptions, } from './provider-client.js';
 export { toProviderClientError } from './to-error.js';
 export { type CatalogEndpoint, type CatalogModel, type CatalogResponse, type CatalogVendor, CENTER_ERROR_CODES, type CenterErrorCode, ENDPOINT_PROTOCOLS, type EndpointProtocol, LLM_CAPABILITIES, LLM_PROTOCOLS, type LlmCapability, type LlmProtocol, type ModelPricing, PC_HEADERS, PROXY_ROUTE_PREFIX, REASONING_EFFORTS, type ReasoningEffort, VENDOR_CATEGORIES, VENDOR_KINDS, type VendorCategory, type VendorKind, } from './types.js';
 export { type AdviceModelView, findVendorAdapter, getVendorAdapter, LlmVendorAdapter, type ModelAdvice, type ProviderOptions, type SamplingParams, VENDOR_ADAPTERS, type VendorFetch, } from './vendors/index.js';
+export { createWebSearch, type CreateWebSearchInput, isWebSearchKind, KIMI_SEARCH_TIERS, type KimiSearchTier, WEB_SEARCH_ADAPTERS, WEB_SEARCH_FILTERS, WEB_SEARCH_KINDS, WEB_SEARCH_RECENCIES, type WebPageOutcome, type WebSearch, type WebSearchAdapter, type WebSearchConnection, type WebSearchFilter, type WebSearchInput, type WebSearchItem, type WebSearchKind, type WebSearchOutcome, type WebSearchRecency, type WebSearchSettings, type WebSearchSettingsByKind, type WebSearchTraits, WebSearchUpstreamError, ZHIPU_SEARCH_ENGINES, type ZhipuSearchEngine, } from './web-search/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EACL,KAAK,WAAW,EAChB,mBAAmB,EACnB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,eAAe,EACpB,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,eAAe,EACpB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,eAAe,EACpB,iBAAiB,EACjB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,eAAe,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,11 @@
 export { createCenterFetch } from './center-fetch.js';
 export { DirectModelResolver, } from './direct-resolver.js';
 export { ProtocolUnavailableError, ProviderClientError, } from './errors.js';
+export { classifyCode, createJustOne, JUSTONE_BASE_URL, JUSTONE_ENDPOINTS, JUSTONE_FAILURE_KINDS, JUSTONE_PRICE_FEN, JUSTONE_PRICING_EXPORTED_AT, JUSTONE_TIMEOUT_MS, justOneEndpointSpec, JustOneParamsError, justOnePriceFen, JustOneUpstreamError, normalizeParams, } from './justone/index.js';
+export { BibiGptApiError, BibiGptNetworkError, buildPolishPrompt, createMedia, directMediaConnection, isMediaKind, localizeSummaryHeadings, MEDIA_ADAPTERS, MEDIA_CAPABILITIES, MEDIA_KINDS, MediaUpstreamError, pageFromExpertName, parseParserPackage, ZHIPU_AUDIO_MAX_BYTES, ZHIPU_FILE_TOOL_TYPES, ZHIPU_MIME_TO_EXT, } from './media/index.js';
 export { ProviderClient, } from './provider-client.js';
 export { toProviderClientError } from './to-error.js';
 export { CENTER_ERROR_CODES, ENDPOINT_PROTOCOLS, LLM_CAPABILITIES, LLM_PROTOCOLS, PC_HEADERS, PROXY_ROUTE_PREFIX, REASONING_EFFORTS, VENDOR_CATEGORIES, VENDOR_KINDS, } from './types.js';
 export { findVendorAdapter, getVendorAdapter, LlmVendorAdapter, VENDOR_ADAPTERS, } from './vendors/index.js';
+export { createWebSearch, isWebSearchKind, KIMI_SEARCH_TIERS, WEB_SEARCH_ADAPTERS, WEB_SEARCH_FILTERS, WEB_SEARCH_KINDS, WEB_SEARCH_RECENCIES, WebSearchUpstreamError, ZHIPU_SEARCH_ENGINES, } from './web-search/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAEL,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAEpB,MAAM,aAAa,CAAC;AASrB,OAAO,EAEL,cAAc,GAEf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAKL,kBAAkB,EAElB,kBAAkB,EAElB,gBAAgB,EAChB,aAAa,EAIb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAEjB,iBAAiB,EACjB,YAAY,GAGb,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAIhB,eAAe,GAEhB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAEL,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAEpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,aAAa,EAEb,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,2BAA2B,EAC3B,kBAAkB,EAMlB,mBAAmB,EAInB,kBAAkB,EAGlB,eAAe,EAEf,oBAAoB,EAGpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EAEjB,WAAW,EAEX,qBAAqB,EAGrB,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,WAAW,EASX,kBAAkB,EAClB,kBAAkB,EAElB,kBAAkB,EAOlB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAIL,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAKL,kBAAkB,EAElB,kBAAkB,EAElB,gBAAgB,EAChB,aAAa,EAIb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAEjB,iBAAiB,EACjB,YAAY,GAGb,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAIhB,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EAEf,eAAe,EACf,iBAAiB,EAEjB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EAcpB,sBAAsB,EACtB,oBAAoB,GAErB,MAAM,uBAAuB,CAAC"}

package/dist/justone/client.d.ts

@@ -0,0 +1,101 @@
+import type { VendorFetch } from '../vendors/index.js';
+import type { JustOneEndpointSpec, JustOneParamsOf } from './endpoint-spec.js';
+import { JUSTONE_ENDPOINTS } from './endpoints.generated.js';
+import { type JustOneFailureKind } from './errors.js';
+export declare const JUSTONE_BASE_URL = "https://api.justoneapi.com";
+/** 官方建议 120 秒：服务端是现场去平台采集的，60 秒以下会有一部分请求等不到结果。 */
+export declare const JUSTONE_TIMEOUT_MS = 120000;
+export type JustOneEndpointKey = keyof typeof JUSTONE_ENDPOINTS;
+/** 接口 `K` 的入参类型（必填 / 可选 / 枚举都按登记表收窄）。 */
+export type JustOneParams<K extends JustOneEndpointKey> = JustOneParamsOf<(typeof JUSTONE_ENDPOINTS)[K]>;
+/**
+ * 出站方式。中心模式（`ProviderClient.justOne`）不给 `token`：fetch 是中心模式 fetch，中心按厂商描述把 key 注入
+ * query 或表单字段 `token`。直连（本地开发、测试）给明文 token，用完即弃，不进记录、不进错误信息。
+ */
+export interface JustOneConnection {
+    /** 缺省 `JUSTONE_BASE_URL`。 */
+    baseUrl?: string;
+    token?: string;
+    /** 缺省全局 fetch。 */
+    fetch?: VendorFetch;
+}
+/**
+ * 一次真正发出去的请求（重试各一条、调用方中途取消也一条——都可能扣费）。参数核对没过、根本没发出去的不报；
+ * 中心自己拦下的（没有可用 key、不许用这家……）也不报，那些请求没到 JustOne。
+ */
+export interface JustOneAttemptRecord<C = unknown> {
+    endpoint: string;
+    /** 核对后线上的参数（不含 token）。 */
+    params: Record<string, string>;
+    attempt: number;
+    ok: boolean;
+    failureKind?: JustOneFailureKind;
+    code: number | null;
+    httpStatus: number | null;
+    requestId: string | null;
+    error?: string;
+    elapsedMs: number;
+    /** 原始返回体（已抹掉 token）；没拿到返回体（连接失败、超时、取消）就没有。 */
+    response?: string;
+    /** 中心模式下实际用的那把 key（`x-pc-credential`）；直连或没拿到响应是 null。 */
+    credential: string | null;
+    /** 定价表里的单价（分），null = 价格未知。 */
+    unitPriceFen: number | null;
+    /** 调用方给的 `JustOneCallOptions.context`，原样带回。 */
+    context: C | undefined;
+}
+export interface JustOneOptions<C = unknown> {
+    connection: JustOneConnection;
+    /**
+     * 每一次真正发出去的请求都调它（调用审计、花费由 APP 记）。放在这里而不是每次调用传，记录就不会被哪个调用方漏掉。
+     * 会被 await；**它不该抛**——走到这里时请求已经发出去了（成功的那次已经扣了费），让调用因记录失败而失败，
+     * 调用方会以为没调成、再调一次、再扣一次费。抛了的话客户端用 `console.error` 报出来，调用照常继续。
+     */
+    onAttempt?: (record: JustOneAttemptRecord<C>) => void | Promise<void>;
+}
+export interface JustOneCallOptions<C = unknown> {
+    /** 谁在调、在哪条对话里；原样进 `onAttempt` 的记录。 */
+    context?: C;
+    /** 调用方的取消信号（工具超时、用户停止）。取消时原样抛出它的 reason，不包成域错误。 */
+    signal?: AbortSignal;
+    /** 单次尝试的超时，缺省 `JUSTONE_TIMEOUT_MS`。 */
+    timeoutMs?: number;
+    /**
+     * 可重试的失败（`JustOneUpstreamError.retryable`）再试几次，缺省 1。
+     * 不确定失败的调用扣不扣费，要省钱的调用方传 0。
+     */
+    retries?: number;
+}
+export interface JustOneResult {
+    endpoint: string;
+    /** 信封里的 `data`。官方没有给出 schema，形状由调用方自己收窄。 */
+    data: unknown;
+    message: string | null;
+    requestId: string | null;
+    /** 服务端记录的采集时间（命中缓存的接口据此看数据新旧）。 */
+    recordTime: string | null;
+    /** 成功那一次的耗时。 */
+    elapsedMs: number;
+    /** 一共试了几次（含首次）。 */
+    attempts: number;
+}
+/**
+ * JustOne（`docs.justoneapi.com`）的调用客户端，连接已绑好。接口与参数来自生成的登记表 `JUSTONE_ENDPOINTS`：
+ *
+ * - 参数在发出前按登记表核对（`normalizeParams`），不对就抛 `JustOneParamsError`，不花钱；
+ * - token（直连时）按接口声明放进 query 或表单请求体；
+ * - 成败看信封里的 `code`（0 = 成功），**不看 HTTP 状态码**——失败时两者都会给，但只有业务码分得清是余额不足还是采集失败；
+ * - 可重试的失败（采集失败 301、服务端 500 / 503、连接失败、中心连不上 JustOne）默认再试一次，超时不重试；
+ * - 中心自己报的错（没有可用 key……）抛 `ProviderClientError`，不重试、不记录。
+ */
+export interface JustOne<C = unknown> {
+    /** 类型化调用：业务代码用这个，接口名与参数在编译期就核对。 */
+    call<K extends JustOneEndpointKey>(endpoint: K, params: JustOneParams<K>, opts?: JustOneCallOptions<C>): Promise<JustOneResult>;
+    /** 接口名与参数在运行期才知道（例如模型选的）。核对规则同 `call`，错误在运行期以 `JustOneParamsError` 报出来。 */
+    callDynamic(endpoint: string, params: Readonly<Record<string, unknown>>, opts?: JustOneCallOptions<C>): Promise<JustOneResult>;
+}
+/** 绑好连接的 JustOne 客户端。中心模式用 `ProviderClient.justOne`；这里是直连与中心模式共用的底层。 */
+export declare function createJustOne<C = unknown>(options: JustOneOptions<C>): JustOne<C>;
+/** 按键查登记表；不在表里返回 undefined（`hasOwn` 不走原型链上的同名属性）。 */
+export declare function justOneEndpointSpec(key: string): JustOneEndpointSpec | undefined;
+//# sourceMappingURL=client.d.ts.map

package/dist/justone/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/justone/client.ts"],"names":[],"mappings":"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"}

package/dist/justone/client.js

@@ -0,0 +1,272 @@
+import { parseCenterError, ProviderClientError } from '../errors.js';
+import { PC_HEADERS } from '../types.js';
+import { JUSTONE_ENDPOINTS } from './endpoints.generated.js';
+import { classifyCode, JustOneParamsError, JustOneUpstreamError, } from './errors.js';
+import { normalizeParams } from './params.js';
+import { justOnePriceFen } from './pricing.js';
+export const JUSTONE_BASE_URL = 'https://api.justoneapi.com';
+/** 官方建议 120 秒：服务端是现场去平台采集的，60 秒以下会有一部分请求等不到结果。 */
+export const JUSTONE_TIMEOUT_MS = 120_000;
+/** 两次尝试之间的间隔。 */
+const RETRY_DELAY_MS = 1_000;
+/** 绑好连接的 JustOne 客户端。中心模式用 `ProviderClient.justOne`；这里是直连与中心模式共用的底层。 */
+export function createJustOne(options) {
+    const conn = options.connection;
+    const base = (conn.baseUrl ?? JUSTONE_BASE_URL).replace(/\/+$/, '');
+    const doFetch = conn.fetch ?? globalThis.fetch;
+    const record = async (r) => {
+        if (!options.onAttempt)
+            return;
+        try {
+            await options.onAttempt(r);
+        }
+        catch (err) {
+            console.error(`[provider-client] JustOne onAttempt threw (${r.endpoint}, attempt ${r.attempt}): ${String(err)}`);
+        }
+    };
+    const attempt = async (spec, values, opts) => {
+        const fields = new URLSearchParams(conn.token ? { ...values, token: conn.token } : values);
+        const query = fields.toString();
+        const url = spec.paramsIn === 'query' && query
+            ? `${base}${spec.path}?${query}`
+            : `${base}${spec.path}`;
+        const timeout = AbortSignal.timeout(opts.timeoutMs ?? JUSTONE_TIMEOUT_MS);
+        const signal = opts.signal
+            ? AbortSignal.any([opts.signal, timeout])
+            : timeout;
+        const started = Date.now();
+        let res;
+        let text;
+        try {
+            res = await doFetch(url, {
+                method: spec.method,
+                headers: { accept: 'application/json' },
+                ...(spec.paramsIn === 'form' ? { body: fields } : {}),
+                signal,
+            });
+            text = await res.text();
+        }
+        catch (err) {
+            const failure = {
+                code: null,
+                httpStatus: null,
+                requestId: null,
+                credential: null,
+                elapsedMs: Date.now() - started,
+            };
+            // 请求可能已经到了对方那里（可能扣了费），所以取消也要记一行；由调用循环记完再抛。
+            if (opts.signal?.aborted) {
+                return {
+                    ok: false,
+                    kind: 'aborted',
+                    reason: '调用方取消了这次请求',
+                    retryable: false,
+                    ...failure,
+                };
+            }
+            if (timeout.aborted) {
+                return {
+                    ok: false,
+                    kind: 'timeout',
+                    reason: `等了 ${Math.round((Date.now() - started) / 1000)} 秒没有返回`,
+                    retryable: false,
+                    ...failure,
+                };
+            }
+            // 只取错误类名与 cause 的 code（`UND_ERR_SOCKET` 之类）：直连时 GET 的 token 就在 URL 里。
+            return {
+                ok: false,
+                kind: 'network',
+                reason: `连接失败（${describeNetworkError(err)}）`,
+                retryable: true,
+                ...failure,
+            };
+        }
+        const elapsedMs = Date.now() - started;
+        const credential = res.headers.get(PC_HEADERS.credential);
+        const httpStatus = res.status;
+        // 中心自己的错误体（`{ code: '<字符串>', message }`，没有 `x-pc-credential`）：请求没到 JustOne。
+        if (!res.ok && !credential) {
+            const center = centerError(text);
+            if (center?.code === 'upstream_error') {
+                return {
+                    ok: false,
+                    kind: 'network',
+                    reason: `中心连不上 JustOne（${center.message}）`,
+                    code: null,
+                    httpStatus,
+                    requestId: null,
+                    retryable: true,
+                    elapsedMs,
+                    credential: null,
+                };
+            }
+            if (center) {
+                throw new ProviderClientError(center.code, center.message, httpStatus);
+            }
+        }
+        // 对方的报错里万一回显了 token：先抹掉再往下走，于是记录里的返回体、错误信息都从这份抹过的文本来。
+        const response = conn.token ? text.split(conn.token).join('***') : text;
+        let body;
+        try {
+            body = JSON.parse(response);
+        }
+        catch {
+            return invalidResponse(httpStatus, `不是 JSON：${response.slice(0, 120)}`, elapsedMs, response, credential);
+        }
+        if (!isEnvelope(body)) {
+            return invalidResponse(httpStatus, 'JSON 里没有数字型的 code', elapsedMs, response, credential);
+        }
+        const requestId = typeof body.requestId === 'string' ? body.requestId : null;
+        const message = typeof body.message === 'string' ? body.message : null;
+        if (body.code !== 0) {
+            return {
+                ok: false,
+                ...classifyCode(body.code, message),
+                code: body.code,
+                httpStatus,
+                requestId,
+                elapsedMs,
+                response,
+                credential,
+            };
+        }
+        return {
+            ok: true,
+            response,
+            credential,
+            result: {
+                data: body.data ?? null,
+                message,
+                requestId,
+                recordTime: typeof body.recordTime === 'string' ? body.recordTime : null,
+                elapsedMs,
+                httpStatus,
+            },
+        };
+    };
+    const callDynamic = async (endpoint, params, opts = {}) => {
+        const spec = justOneEndpointSpec(endpoint);
+        if (!spec) {
+            throw new JustOneParamsError(endpoint, ['登记表里没有这个接口']);
+        }
+        const normalized = normalizeParams(spec, params);
+        if (!normalized.ok) {
+            throw new JustOneParamsError(endpoint, normalized.problems);
+        }
+        const retries = Math.max(0, opts.retries ?? 1);
+        const unitPriceFen = justOnePriceFen(endpoint);
+        for (let n = 1;; n++) {
+            opts.signal?.throwIfAborted();
+            const out = await attempt(spec, normalized.values, opts);
+            await record({
+                endpoint,
+                params: normalized.values,
+                attempt: n,
+                response: out.response,
+                credential: out.credential,
+                unitPriceFen,
+                context: opts.context,
+                ...(out.ok
+                    ? {
+                        ok: true,
+                        code: 0,
+                        httpStatus: out.result.httpStatus,
+                        requestId: out.result.requestId,
+                        elapsedMs: out.result.elapsedMs,
+                    }
+                    : {
+                        ok: false,
+                        failureKind: out.kind,
+                        code: out.code,
+                        httpStatus: out.httpStatus,
+                        requestId: out.requestId,
+                        error: out.reason,
+                        elapsedMs: out.elapsedMs,
+                    }),
+            });
+            if (out.ok) {
+                const { httpStatus: _http, ...result } = out.result;
+                return { endpoint, ...result, attempts: n };
+            }
+            if (out.kind === 'aborted') {
+                // 只有调用方的信号已中止时 attempt 才给 aborted：原样抛出取消原因。
+                opts.signal?.throwIfAborted();
+                throw new Error('JustOne attempt reported aborted without a signal');
+            }
+            if (!out.retryable || n > retries) {
+                throw new JustOneUpstreamError(endpoint, out.kind, out.reason, {
+                    code: out.code,
+                    httpStatus: out.httpStatus,
+                    requestId: out.requestId,
+                    retryable: out.retryable,
+                    attempts: n,
+                });
+            }
+            await sleep(RETRY_DELAY_MS, opts.signal);
+        }
+    };
+    return {
+        call: (endpoint, params, opts) => callDynamic(endpoint, params, opts),
+        callDynamic,
+    };
+}
+/** 按键查登记表；不在表里返回 undefined（`hasOwn` 不走原型链上的同名属性）。 */
+export function justOneEndpointSpec(key) {
+    return Object.hasOwn(JUSTONE_ENDPOINTS, key)
+        ? JUSTONE_ENDPOINTS[key]
+        : undefined;
+}
+function centerError(text) {
+    try {
+        return parseCenterError(JSON.parse(text));
+    }
+    catch {
+        return null;
+    }
+}
+function isEnvelope(v) {
+    return (typeof v === 'object' &&
+        v !== null &&
+        typeof v.code === 'number');
+}
+function invalidResponse(httpStatus, what, elapsedMs, response, credential) {
+    return {
+        ok: false,
+        kind: 'invalid-response',
+        reason: `HTTP ${httpStatus}，响应${what}`,
+        code: null,
+        httpStatus,
+        requestId: null,
+        // 网关层的 5xx（还没到 JustOne 的业务层）值得再试一次。
+        retryable: httpStatus >= 500,
+        elapsedMs,
+        response,
+        credential,
+    };
+}
+function describeNetworkError(err) {
+    if (!(err instanceof Error))
+        return 'unknown';
+    const cause = err.cause;
+    return typeof cause?.code === 'string'
+        ? `${err.name} ${cause.code}`
+        : err.name;
+}
+/** 可被调用方取消的等待：取消时原样抛出信号的 reason。 */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(signal.reason);
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/justone/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/justone/client.ts"],"names":[],"mappings":"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"}

package/dist/justone/endpoint-spec.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 登记表里一个接口的形状（`justone-endpoints.generated.ts` 由脚本从官方 OpenAPI
+ * 生成，见 `packages/client/scripts/generate-justone-endpoints.mjs`）。
+ *
+ * 文字（`title` / `description` / `notes` / 参数说明）都是官方中文文档的原文，
+ * 将来给模型看的工具说明可以直接取用，不必再抄一遍。
+ */
+export interface JustOneEndpointSpec {
+    method: 'GET' | 'POST';
+    path: string;
+    /**
+     * 参数与 token 放哪：`query` 或 `form`（`application/x-www-form-urlencoded`
+     * 请求体）。不能按方法推断——官方有几个 POST 接口没有请求体、参数全在 query。
+     */
+    paramsIn: 'query' | 'form';
+    /** 官方分类（中文 tag），如「小红书」「抖音巨量星图」。 */
+    platform: string;
+    /** 如「笔记详情 (V1)」。 */
+    title: string;
+    description: string;
+    docsUrl: string;
+    deprecated?: boolean;
+    /** 官方在同一能力的多个版本里推荐的那个。 */
+    recommended?: boolean;
+    /** 官方标注的限制与用法提示（「此版本不支持视频下载」……）。 */
+    notes?: readonly string[];
+    /** 不含 `token`——它由客户端统一放。 */
+    params: Readonly<Record<string, JustOneParamSpec>>;
+}
+export interface JustOneParamSpec {
+    type: 'string' | 'integer' | 'number' | 'boolean';
+    required: boolean;
+    enum?: readonly string[];
+    default?: string | number | boolean;
+    description?: string;
+}
+/** 单个参数的 TS 值类型：有枚举就收窄成字面量。 */
+type ParamValue<P extends JustOneParamSpec> = P['enum'] extends readonly (infer E)[] ? E : P['type'] extends 'integer' | 'number' ? number : P['type'] extends 'boolean' ? boolean : string;
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** 一个接口的入参类型：必填的必填、可选的可选，名字与取值都按登记表收窄。 */
+export type JustOneParamsOf<S extends JustOneEndpointSpec> = Simplify<{
+    -readonly [K in keyof S['params'] as S['params'][K]['required'] extends true ? K : never]: ParamValue<S['params'][K]>;
+} & {
+    -readonly [K in keyof S['params'] as S['params'][K]['required'] extends true ? never : K]?: ParamValue<S['params'][K]>;
+}>;
+export {};
+//# sourceMappingURL=endpoint-spec.d.ts.map

package/dist/justone/endpoint-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-spec.d.ts","sourceRoot":"","sources":["../../src/justone/endpoint-spec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+BAA+B;AAC/B,KAAK,UAAU,CAAC,CAAC,SAAS,gBAAgB,IACxC,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAClC,CAAC,GACD,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAAG,QAAQ,GACpC,MAAM,GACN,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GACzB,OAAO,GACP,MAAM,CAAC;AAEjB,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAEjD,0CAA0C;AAC1C,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,mBAAmB,IAAI,QAAQ,CACnE;IACE,CAAC,UACC,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAC7D,CAAC,GACD,KAAK,GACR,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9B,GAAG;IACF,CAAC,UACC,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAC7D,KAAK,GACL,CAAC,CACN,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/B,CACF,CAAC"}

package/dist/justone/endpoint-spec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=endpoint-spec.js.map

package/dist/justone/endpoint-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-spec.js","sourceRoot":"","sources":["../../src/justone/endpoint-spec.ts"],"names":[],"mappings":""}